docs(discovery-plane): finalize operator guide now that the plane is shipped and live#8168
Conversation
…shipped and live #7164/#7166/#7167 all closed and the discovery-index server is now deployed at discovery.loopover.ai (Cloudflare Container + Worker). Rewrites the operator guide (packages/loopover-miner + the mirrored docs-site mdx) from "provisional/TBD" to the real, shipped opt-in mechanism: - Documents the real env vars, including LOOPOVER_MINER_DISCOVERY_SHARED_SECRET (used for bearer auth against the hosted index), which wasn't in the original TBD list at all. - Adds the maintainer-run instance's real URL and a verification step (dry-run discover) to the opt-in checklist. - Corrects a real invariant-list drift found while verifying: the doc claimed telemetry uses HMAC-hashed repo/issue correlation identifiers, but the shipped recordDiscoveryTelemetry only ever emits a bare {event, outcome} local log line -- no hosted telemetry collector exists yet, so there's nothing to hash today. - Marks server-side soft-claim dedup shipped (was "server-side dedup is #4250 [open]"). Closes #7169.
|
Superagent didn't find any vulnerabilities or security issues in this PR. |
Deploying with
|
| Status | Name | Latest Commit | Preview URL | Updated (UTC) |
|---|---|---|---|---|
| ✅ Deployment successful! View logs |
loopover-ui | 44c2661 | Commit Preview URL Branch Preview URL |
Jul 23 2026, 08:04 AM |
Bundle ReportChanges will increase total bundle size by 1.33kB (0.02%) ⬆️. This is within the configured threshold ✅ Detailed changes
Affected Assets, Files, and Routes:view changes for bundle: loopover-uiAssets Changed:
|
|
Caution 🛑 LoopOver review result - fixes requiredReview updated: 2026-07-23 08:23:57 UTC
Review summary Nits — 7 non-blocking
CI checks failing
Decision drivers
Context & advisory signals — never blocks the verdict
Linked issue satisfactionAddressed Review context
Contributor next steps
Signal definitions
🧪 Chat with LoopOverAsk LoopOver a question about this PR directly in a comment — grounded only in the same cached, public-safe facts shown above, never a new claim.
Full command reference: https://loopover.ai/docs/loopover-commands 🧪 Experimental — new and may change. Visual preview
Click any thumbnail to open the full-size screenshot. Before = production · After = this PR's preview deploy. Scroll preview
A short scroll-through clip (desktop) — click either thumbnail to open the full animation. Evidence for scroll-linked behavior a single screenshot can't show. 🟩 Safe / merged · 🟦 Advisory · 🟨 Held for review · 🟥 Blocked / closed 💰 Earn for open-source contributions like this. Gittensor lets GitHub contributors earn for the work they already do — register to start earning →. Checked by LoopOver, a quiet PR intelligence layer for OSS maintainers.
|
…8174) #8167 fixed the per-shard --changed case (exits 0 with "No test files found"), but --mergeReports exits 1 for the same condition -- a different code path, not covered by that fix. Confirmed live: PR #8168 (the same docs-only PR #8167 was meant to unblock) passed all 3 validate-tests shards but still failed validate-tests-merge with "No test files found, exiting with code 1", even with COVERAGE_NO_THRESHOLDS already disabling the threshold check. Only treats that exact case as success, and only when COVERAGE_NO_THRESHOLDS is set (i.e. this run is the scoped case to begin with) -- in the unscoped full-suite case, "no test files found" while merging is still a real failure worth surfacing loudly.


Summary
discovery.loopover.ai(Cloudflare Container + Worker, deployed this session). Rewrites the operator guide (packages/loopover-miner+ the mirrored docs-site mdx) from "provisional/TBD" to the real, shipped opt-in mechanism.LOOPOVER_MINER_DISCOVERY_SHARED_SECRET(bearer auth against the hosted index), which wasn't in the original TBD list at all.recordDiscoveryTelemetryonly ever emits a bare{event, outcome}local log line — no hosted telemetry collector exists yet, so there's nothing to hash today.Reopened as a fresh PR (was #8165) to force a clean CI run against the current branch tip, now rebased onto #8167's CI fix for the scoped-test-selection zero-files case that originally false-failed this docs-only PR.
Closes #7169.
Test plan
src/**changes, so no Codecov impact.npx prettier --checkpasses on both changed files.curl https://discovery.loopover.ai/health→ 200,/ready→{"ready":true}.discovery-index-client.ts,discovery-index-contract.ts) rather than carrying over the original design doc unchanged.